home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #12 / Amiga Plus CD - 2002 - No. 12.iso / Tools / Updates / PageStreamHelpFiles / readme.txt < prev    next >
Encoding:
Text File  |  2002-11-08  |  20.2 KB  |  422 lines
  1. PageStream4.1 Documentation Project Readme
  2.  
  3. I just did a run through the PageStream User Manual. First, I must say everytime I look at the help system, I am amazed at the
  4. incredible work Mario Galante did. Thanks Mario!!!
  5.  
  6. I'm trying to jot things down as I see them. I've added a few things as I remember them. Obviously just looking at the 4.1 features
  7. (and 4.0 in some cases) is an obvious place to start. Let me know if I missed something!!!
  8.  
  9. I've put my thoughts down in this file as more of a good suggestion than something cast in stone. If a feature would be better
  10. documented in another location in the manual, or some other design issue, just bring it up on the PageStreamDocs list!
  11.  
  12. When linking between sections, remember that this documentation will serve both electronic and printed. So don't put in things like
  13. "Click here", but instead "See also xxxx" or some such (as appropriate) and link the xxxxx to the proper place.
  14.  
  15. Chapters
  16. --------
  17. The manual is divided in chapters. Those chapters are:
  18. Getting Started
  19. Lessons
  20. Document
  21. Text
  22. Objects
  23. Line, Fill & Color
  24. Printing
  25. Scripting
  26. Appendices
  27.  
  28. Each chapter is then subdivided into sections. Each section tries to cover a single major concept (is that the right term?) in that
  29. chapter.
  30.  
  31. Sections
  32. --------
  33. Each section has a single HTML page devoted to it.
  34.  
  35. At the top of the section is the PGS icon and section title kept in a single cell table with no border. That first table usually
  36. contain the "Summary" graphical title (only present when there is a second table with links to anchors into this section).
  37.  
  38. This is occasionally followed by a "summary" of the section at hand. This is not in a table.
  39.  
  40. Then this is usually followed by a list of links into this section's subsections, contained in a second single cell table with no border.
  41.  
  42. The text of the section then follows. Again, not in a table.
  43.  
  44. At the bottom of the section page is the "Browse" graphical title and hypertext links to the previous and next section (or chapter),
  45. links to related topics if applicable, and a link back to the table of contents. Again, contained within a single cell table
  46. with no border.
  47.  
  48. The reason for the borderless tables is to make it possible for an import script to cut out those items contained in a borderless table
  49. so that generating a printed document should be easier. On the other hand, what used to be the printed manuals sidebar items are
  50. now placed in a single cell table with a single pixel border. That will (should? :-) be interpreted as a sidebar item when
  51. recreating the PageStream printed manual.
  52.  
  53. STYLE GUIDE EXAMPLES
  54. --------------------
  55. "choose Custom from the Screen pop-up menu and click its Browse button to ..."
  56. "Click the Browse button to the right of the PPD text box. A file selector will open from which..."
  57. "Select Printers' Marks to print..." "Select Emulsion Down and Negative if..."
  58. "Choose Text Frame Options from the Frame submenu in the Object menu to display the Text Frame Options dialog box."
  59.  
  60. NEW SECTIONS
  61. ------------
  62. I've attempted to create sections where they will be needed, but if a new section is needed (or one divided), just ask on
  63. the PageStreamDocs list. Of course, the same goes for chapters, but I don't see much of a need at this time for any additional
  64. chapters, but if something would be better served by being broken out into its own chapter just ask!
  65.  
  66. THINGS TO DO
  67. ------------
  68.  
  69. Change all tables to not be indented (not handled in MS Explorer properly). Use centered, 90% width instead (10% per indentation level)
  70.  
  71. Should edit script be described? Is it someplace else besides scripts.html?
  72. variable.html: text mark and other not well documented. How about text mark in large doc publishing along with examples?
  73. Is nudge object documented? How about transform with count 0?
  74. Is drag/drop text documented? (Including ability to drop text into new frameless text object, ie anywhere on the page)
  75. Is Edit -> Information documented anywhere?
  76. Object:
  77.     Where is drawing tables, grids, and columns described? Not in usingobjects...
  78. Text in general
  79.     references to articles & frameless text objects should include references to table cells as well (if there are any)
  80. Lessons 1 & 2 are missing graphics. At some point in time they got lost. If someone has them, please email them to me at support@grasshopperllc.com. Thanks!
  81.  
  82.  
  83. *** "done" except Mac screenshots ***
  84. lesson1.html    *** new version 11/8/02 ***
  85. lesson2.html    *** new version 11/8/02 ***
  86.     need Mac "Screenshots/SetPageGuides21.43p6.gif"
  87.     need Mac "Screenshots/SetPageGuides22p6.43.gif"
  88.     need Mac "Screenshots/Lesson2.Tabs.gif"
  89. customizing.html *** new version 11/7/02 *** files/folder/type/general prefs ***
  90.     need Mac "Screenshots/Prefs.*.gif"
  91.     need Mac "Illustrations/PrefsTab.GIF"
  92. usingtext.html    *** new version 11/7/02 ***
  93. reshaping.html *** new version 11/5/02 ***
  94.     new Mac "Illustrations/ReshapeTable.BorderFill.gif"
  95.     new Mac "Screenshots/ReshapeTable.Cell.gif"
  96.     new Mac "Screenshots/ReshapeTable.DeleteC.gif"
  97.     new Mac "Screenshots/ReshapeTable.DeleteR.gif"
  98.     new Mac "Screenshots/ReshapeTable.InsertC.gif"
  99.     new Mac "Screenshots/ReshapeTable.InsertR.gif"
  100.     new Mac "Screenshots/ReshapeTable.Join.gif"
  101.     new Mac "Screenshots/ReshapeTable.Split.gif"
  102.     new Mac "Screenshots/ReshapeTable.Value.gif"
  103.     new Mac "Screenshots/ReshapeTable.WH.gif"
  104. newslabels.html *** new version 11/4/02 - signature/repeating/mail merge ***
  105.     new Mac "Screenshots/Print.Imposition.Signature.gif"
  106.     new Mac "Screenshots/Print.Imposition.Repeating.gif"
  107.     new Mac "Screenshots/Print.MailMerge.gif"
  108. largedocpub.html  *** new version 10/28/02 * indexing/toc/tof ***
  109.     indexing
  110.     new Mac "Screenshots/DefineIndexTopics.gif"
  111.     new Mac "Screenshots/EditIndexXRef.gif"
  112.     new Mac "Screenshots/InsertIndexMark.gif"
  113.     new Mac "Screenshots/IndexTopicMarks.gif"
  114.     new Mac "Screenshots/GenerateIndex.gif"
  115.     table of contents
  116.     new Mac "Illustrations/IncludeInTOC.gif"
  117.     new Mac "Screenshots/GenerateTOC.gif"
  118.     table of figures
  119.     new Mac "Screenshots/DefineFigureType.gif"
  120.     new Mac "Screenshots/EditFigureType.gif"
  121.     new Mac "Screenshots/FigureMarks.gif"
  122.     new Mac "Screenshots/InsertFigure.gif"
  123.     new Mac "Screenshots/InsertFigureNumber.gif"
  124.     new Mac "Screenshots/InsertFigurePageNum.gif"
  125.     new Mac "Screenshots/InsertFigureName.gif"
  126.     new Mac "Screenshots/GenerateTOF.gif"
  127. usingobjects.html *** new version 10/27/02 ***
  128. layers.html *** new version 10/20/02 * all new ***
  129.     new Mac "Illustrations/Layer.Make.gif"
  130.     new Mac "Screenshots/Obj.Info.gif"
  131.     new Mac "Illustrations/Layer.Info.gif"
  132.     new Mac "Illustrations/Layer.Flatten.gif"
  133.     new Mac "Illustrations/Layer.UpDown.gif"
  134.     new Mac "Illustrations/Layer.Active.gif"
  135.     new Mac "Illustrations/Layer.Lock.gif"
  136.     new Mac "Illustrations/Layer.Eye.gif"
  137. variable.html *** new version 10/18/02 * redid date/time, new revision & variable ***
  138.     new Mac "Screenshots/InsertRevisionNum.gif"    
  139.     new Mac "Screenshots/DefineVariableString.gif"    
  140.     new Mac "Screenshots/InsertVariableString.gif"    
  141.     new Mac "Screenshots/EditVariableString.gif"    
  142. findchange.html *** new version 10/17/02 * find change attributes ***
  143.     needs Mac "Screenshots/FindChangeAttr.gif"
  144.     needs Mac "Screenshots/FindChange.gif"
  145.     redo "Illustrations/Finding.GIF" with text "Finding and Replacing Text"
  146. scripts.html *** new version 10/17/02 * Mac OS 9 tip ***
  147. separations.html
  148.     need Mac "Screenshots/PlateControl.gif"
  149. desktopprint.html
  150.     need Mac "Screenshots/Print.gif"
  151. wwwpublishing.html *** new version 10/16/02 * Save as PDF including limitations ***
  152.     need Mac "Screenshots/SaveAsPDF.gif"
  153. tranformation.html *** new version 10/15/02 * Transform ***
  154.     New shot of "Screenshots/Transform.GIF"
  155. character.html *** new version 10/15/02 * Define Tracking & Define Kerning Pairs ***
  156.     need Mac "Screenshots/DefineTracking.gif"
  157.     need Mac "Screenshots/DefineKerning.gif"
  158. navigating.html    *** royleith <r.m.leith@btinternet.com> * bookmarks ***
  159.     need Mac "Screenshots/Bookmarks.gif"
  160.     need Mac "Screenshots/InsertBookmark.gif"
  161.     need Mac "Screenshots/EditBookmark.gif"
  162. masterpages.html *** new version 10/10/02 *** Page Setup page range ***
  163.     need Mac "Screenshots/PageSetup.gif"
  164. paragraph.html ***new version 10/10/02 *** numbered paragraphs, paragraph rules, define hyphenation batch add and export ***
  165.     need Mac "Screenshots/ParagraphFormat.gif"
  166.     need Mac "Screenshots/DefineHyphenation.gif"
  167. puttingtext.html *** new version 10/9/02 *** custom text frame requester ***
  168.     need Mac "Screenshots/TextFrame.gif"
  169. charactersets.html    *** new version 10/14/02 *** royleith <r.m.leith@btinternet.com> ***
  170. imagesetter.html *** new version 10/14/02 *** collect for output ***
  171. separations.html
  172.     need Mac "Screenshots/PlateControl.gif"
  173. print.html
  174.     need Mac "Screenshots/Print.gif"
  175. spellchecking.html *** new version 10/10/02 *** lookup words batch add and export ***
  176.     need Mac "Screenshots/LookupWord.GIF"
  177. pages.html *** new version 10/8/02 *** move pages between chapters ***
  178.     need Mac "Screenshots/MovePage.gif"
  179. exploring.html *** new version 10/27/02 ***
  180.     new Mac "Screenshots/Toolbox.lasso.gif"
  181.     new Mac "Screenshots/Toolbox.table.gif"
  182. selectingtext.html    *** new version 10/4/02 ***
  183. editing.html *** new version 10/9/02 ***
  184.  
  185.  
  186.  
  187. PGScmd
  188. Chris Elliott <sembazuru@crosswinds.net>
  189.  
  190. HHV
  191. ---
  192. navigating.html
  193.     add info on TOC vs Interface TOC
  194.     add info on the common questions and browsing links at bottom of each page.
  195.  
  196. FOOD FOR THOUGHT
  197. ----------------
  198. Should the layout grid section be reworked? What to call it?
  199.  
  200. It has been suggested that GUI objects (such as button labels, menu names, etc) be styled in some way to set it apart from the rest of the
  201. text such as Bold, or another font or...
  202.  
  203. Should Save as PDF be documented in Print or Document? Currently in print, since it is an "output" method.
  204.  
  205. How well should the Fade To transform function be documented? A great many unusual circumstances (especially the HSV color fades!)
  206.  
  207. A standard way of denoting "index marks" for each section/subsection should be created. It would be simple enough to enter these
  208. in the bottom "browse" table or some other table at the end, but we may need more placement precision for larger sections. Placing them
  209. in HTML comments however would make "out of the way" but would of course make them harder to edit for everyone.
  210.  
  211. Many of the Illustration GIFs will be too low resolution for printing. I think that eps (with gif previews) or ilus files named the same
  212. but with the proper extension (.eps or .ilus) would make it possible to replace the .gif files pretty easy for printing.
  213.  
  214. What about Aquire? Not documented, and not supported yet. Either write driver for this, or delete it until then!
  215.  
  216. Since all "generic" PageStream requesters are screenshots from the Mac, we should stick with that for now it at all possible. For those
  217. who don't have Macs, it will be simple enough for someone else with a Mac to create new ones. I would propose that if folks felt we needed
  218. to do so, we could create screenshots specific to each of the platforms (stick them in Screenshots.Windows or Screenshots.Amiga or ... ??)
  219. With that in mind, should platform specific screen shots that are in Illustrations be moved to screenshots folder instead?
  220.  
  221. If someone needs to take new screen shots, and they are not on the Mac, just go
  222. ahead and take a shot on what ever platform you have. Just let me know, and
  223. I'll add them to a list of screenshots that need to be redone. You can document
  224. with Amiga/Windows screen shots, and we will be one step closer to having
  225. "localized" screenshots as well.
  226.  
  227.  
  228.  
  229.  
  230.  
  231. EMAILS
  232. ------
  233. Deron Kazmaier <support@grasshopperllc.com> Re: Capitalize Chapter # Insert
  234. > The only options are upper case or lower case. However, you can use a
  235. > script command to capatilize. To do this, just insert the page number
  236. > in long mode. Create a new script which has the line "SETCASE
  237. > CAPITALIZED", hilight the page number, and run the script! You can do
  238. > this for any variable.
  239.  
  240. Deron Kazmaier <support@grasshopperllc.com> Re:
  241. >Anyway, I installed latest Amiga version of PageStream (V4.1.3.4) and have 
  242. >some questions about it:
  243. >
  244. >- I'm wondering - are there keyboard shortcuts for resizing fonts? 
  245. >Currently I only know of key-shortcuts for font spacing (CTRL + [ or ]) 
  246. >but not resizing? And are there any key-shortcuts for font vertical spacing?
  247. Yes, there are. In fact just fixed a bug in Windows version that was 
  248. causing the others to not work (but you say you are on the Amiga, which 
  249. should be fine).
  250. In case you can't get to it in the manual.
  251. control >       type size larger
  252. control-alt >   type size larger by 1pt
  253. control <       type size smaller
  254. control-alt <   type size smaller by 1pt
  255. control /       insert indent mark
  256. control \       leading looser by 5
  257. control-alt \   leading looser by 1
  258. control ;       leading tighter by 5
  259. control-alt ;  leading tighter by 1
  260. control =       insert non-breaking hyphen
  261. control -       insert soft hyphen
  262. control space   insert non-breaking space
  263. control }       type width larger by 5%
  264. control-alt }   type width larger by 1%
  265. control {       type width smaller by 5%
  266. control-alt {   type width smaller by 1%
  267. control ]       track looser by 5
  268. control-alt ]   track looser by 1
  269. control [       track tighter by 5
  270. control-alt [       track tighter by 1
  271. For tracking: If instead of range of text selected, the cursor is between 
  272. two character, effects manual kerning instead.
  273.  
  274.  
  275. OBJECT - paths drawing
  276. Peter Martin <pjmartin@magma.ca>
  277. page 153      - The first drawing - Shows two segments with three points.  It
  278. calls the third point a ‘point handle'?
  279.  
  280. page 155      - I find some confusion on this page.
  281.             - At the end of the paragraph numbered "1", the action of releasing
  282. the mouse button should be mentioned.
  283.             - ‘Press and hold the mouse button' should be repeated after the first
  284. sentence in paragraph numbered "2".
  285.             - In paragraph numbered "2", the third drawing - the associated text
  286. is erroneous. Releasing the mouse button ends the curve handle, and
  287. pressing the button ends the segment.
  288.             - In part numbered "3" the second paragraph is incomplete. What
  289. actually happens is that the (alt) key works as described (here, and in
  290. part 1) if a curved segment is continuing from a straight segment. If a
  291. curved segment is continuing from another curved segment the (alt) key
  292. action creates a corner joint. If either type of segment is added to an
  293. existing segment (the drawing action is interrupted by the ESC key and
  294. then restarted), the (alt) key does nothing at all.
  295.  
  296. Some time reading isn't good enough, one has to play with the features
  297. to find the mistakes. - Oh well!
  298.  
  299.  
  300. OBJECT - pictures
  301. Geoffrey Gass <ggass@teleport.com> RE:Using Mask Graphic for Text Fill
  302. Using the Object/Mask/Mask Graphic function in PageStream is a convenient
  303. way to create colorful patterned or textured fill for text. But the other
  304. day, a greeting card with two such fills (a total of 8 characters in
  305. 108-point type) that should have been a 600k file, ballooned out to 
  306. nearly 4 megs in size.
  307.  
  308. The fill graphics were JPEG images. They seemed harmless enough -- 
  309. the biggest was 129k. The texts were positioned over suitable areas of
  310. each, and Mask Graphic was invoked to provide the fill for the letters.
  311.  
  312. Problem: What happened?
  313.  
  314. First, a JPEG image when placed in PageStream is decompressed into 
  315. a standard bitmap format. In one case, the compression had been around
  316. 15:1 -- the image in PageStream amounted to some 1.9 megabytes.
  317.  
  318. Second, the masking process in PageStream does not delete any part of
  319. the image, it just makes some parts invisible.
  320.  
  321. As it happened, one of the original JPEG's was 720 x 900 pixels, of which
  322. only 720 x 360 were actually used for letter-fill -- the other 720 x 540
  323. x 3 bytes were just masked out. The same was true of the other fill image.
  324.  
  325. Solution: To void surprises in file size and processing time:
  326.  
  327. 1. With JPEG's to be used as text fill, first bring them into BME to
  328. evaluate their actual bitmap size. This will give an idea of their
  329. effect on file size and processing time.
  330.  
  331. 2. For any graphic to be used for text fill, use the Crop function in
  332. BME to delete any portion of the graphic that will not be used for fill.
  333. Cropping actually deletes part of the image file. Save the cropped 
  334. image in a standard bitmap format (TIFF, IFF, &c), rather than saving 
  335. in JPEG, which may degrade the image.
  336.  
  337. 3. If the file size still looks excessive, consider reduction from
  338. 24-bit to a smaller color range. For text fill, 256 or even 16 colors
  339. may be adequate in many cases.
  340.  
  341. In the problem at hand, these measures brought the file size down to a
  342. manageable 450k -- a better than 8-1 improvement.  
  343.  
  344.  
  345. PRINTING
  346. Not sure if these have a place in the PageStream manual, but they get asked pretty often:
  347.  
  348. Michael Czajka <MC1@pobox.com> RE: Printing from Amithlon
  349. Tried editing Devs/nsdpatch.cfg and putting the line below into it (anywhere is OK) and
  350. it works.
  351. DEVICE parallel.device UNIT 0 MAPTODEVICE powerpar.device MAPTOUNIT 0
  352. Then use Par:
  353.  
  354.  
  355. "hornpipe101" <apace@tig.com.au> RE: hyperCOM3 board output
  356. The HyperPAR.device is seen as a file by Pagestream and any output from Pagestream will overwrite it. Do as I did with the Amithlon which does not provide PAR:
  357. Download Port-Handler by Stephan Rupprecht from the Aminet and copy it to L: directory. Make a new mount file in Devs:DOSdrivers called HyperPAR (or whatever you want)  containing the following info:
  358. EHandler = L:Port-handler
  359. Stacksize = 1024
  360. Priority = 5
  361. Device = HyperPAR.device
  362. Unit = 0
  363. Baud = 0
  364. You can then specify HyperPAR: as a device  in Pagestream and print directly to any Pagestream supported printer.
  365. As a matter of interest the above should be available with the HyperCom3 software in the Goodies directory. The Aminet PortHandler is a later version of that available with the HyperCom3.
  366. Make sure that you still have the correct HyperPAR.device in devs: as Pagestream may have overwritten it.
  367. ----
  368. Copy the file HC3PAR and its info file into Devs: Dosdrivers directory
  369. Copy file port-handler  to L: directory
  370. Reboot
  371. Go to Shell , type in assign and then Enter
  372. You should see HC3PAR listed under Devices.
  373. Fire up Pagestream and in Printer setup menu select the Pagestream printer you wish to use..
  374. In the "Send to" box select "Device"  and in the next box type HC3PAR: (do not forget the colon otherwise you will produce a file called HC3PAR)
  375. You should now be able to print. 
  376.  
  377.  
  378. "Johnny C. Kitchens" <kitchens@letter.com>  Re: Mailing PDF from YAM and getting corrupted
  379. To fix the problem, goto YAM's configuration, goto MIME, on the
  380. right you will see "Attachment type". Put "application/pdf" in there. In
  381. "Extension" put "pdf". In "Viewer" put "[PROGRAMPATH]/Apdf "%s" and you will
  382. have no more problems sending...
  383.  
  384.  
  385.  
  386.  
  387. *******************
  388. PageStream (and BME) Commands
  389.  
  390. I think I found an error in the BME commands help file. Looking up how
  391. getpicture works, I see this in the help file:
  392. --------------------------8<--------------------------
  393. GETPICTURE Queries
  394. Queries BME to find if a picture is open.
  395. getpicture <name>
  396. NAME/s The picture name. Default=current.
  397. ARexx Errors:
  398. Returns 10 to RC if the picture is not open.
  399. ARexx Examples:
  400. getpicture 'pagestream:graphics/mygraphic.ilbm'
  401. if rc~=0 then say 'Picture is open.'
  402. else say 'Picture is not open!'
  403. -------------------------->8--------------------------
  404. If getpicture returns a 10 in RC if the picture is not open, then  why
  405. is  the example (and SendtoBME.rexx) looking for a 0 in RC to indicate
  406. the picure not open?
  407. Which is correct? 10 or 0?
  408. According to experimentation on my part,  it  seems  that  10  is  the
  409. correct  answer  here.  (I've been wondering why SendtoBME.rexx didn't
  410. update PageStream with my finished artwork...)  Hmmm...  actually,  my
  411. experimentation  (using  commandline rexx, and then a script) seems to
  412. break execution of the script when it returns a 10. i.e. when  I  have
  413. 'temp:pics/3balls.iff' open in BME, the following errors out with 10:
  414. rx "options results;address BME getpicture 'temp:pics/foo';say rc"
  415. but the following quietly replies with 0:
  416. rx "options results;address BME getpicture 'temp:pics/3balls.iff';say rc"
  417. After further playing, I see (as I should have to start) that this  is
  418. dependant  on  failat level. (I was at failat 10...) What failat level
  419. does PGS set when executing a script?
  420.  
  421.  
  422.